package com.ruoyi.campus.service;

import com.ruoyi.campus.domain.AlarmRecord;

import java.util.Date;
import java.util.List;
import java.util.Map;

/**
 * 报警记录Service接口
 * 
 * @author campus-alarm
 * @date 2024-01-01
 */
public interface IAlarmRecordService 
{
    /**
     * 查询报警记录
     * 
     * @param alarmId 报警记录主键
     * @return 报警记录
     */
    AlarmRecord selectAlarmRecordByAlarmId(Long alarmId);

    /**
     * 查询报警记录列表
     * 
     * @param alarmRecord 报警记录
     * @return 报警记录集合
     */
    List<AlarmRecord> selectAlarmRecordList(AlarmRecord alarmRecord);

    /**
     * 查询报警记录详情（包含关联信息）
     * 
     * @param alarmId 报警ID
     * @return 报警记录
     */
    AlarmRecord selectAlarmRecordDetail(Long alarmId);

    /**
     * 根据报警编号查询报警记录
     * 
     * @param alarmCode 报警编号
     * @return 报警记录
     */
    AlarmRecord selectAlarmRecordByCode(String alarmCode);

    /**
     * 查询用户的报警记录
     * 
     * @param userId 用户ID
     * @param userType 用户类型
     * @return 报警记录集合
     */
    List<AlarmRecord> selectAlarmRecordByUser(Long userId, Integer userType);

    /**
     * 查询学校的报警记录
     * 
     * @param schoolId 学校ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 报警记录集合
     */
    List<AlarmRecord> selectAlarmRecordBySchool(Long schoolId, Date startTime, Date endTime);

    /**
     * 查询待处理的报警记录
     * 
     * @param schoolId 学校ID（可选）
     * @return 报警记录集合
     */
    List<AlarmRecord> selectPendingAlarmRecords(Long schoolId);

    /**
     * 查询紧急报警记录
     * 
     * @param schoolId 学校ID（可选）
     * @return 报警记录集合
     */
    List<AlarmRecord> selectEmergencyAlarmRecords(Long schoolId);

    /**
     * 查询超时未处理的报警记录
     * 
     * @param timeoutMinutes 超时分钟数
     * @return 报警记录集合
     */
    List<AlarmRecord> selectTimeoutAlarmRecords(Integer timeoutMinutes);

    /**
     * 查询实时报警数据（最近24小时）
     * 
     * @param schoolId 学校ID（可选）
     * @return 报警记录集合
     */
    List<AlarmRecord> selectRealtimeAlarmData(Long schoolId);

    /**
     * 统计报警数据
     * 
     * @param schoolId 学校ID（可选）
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 统计结果
     */
    Map<String, Object> selectAlarmStatistics(Long schoolId, Date startTime, Date endTime);

    /**
     * 按时间段统计报警数量
     * 
     * @param schoolId 学校ID（可选）
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @param groupBy 分组方式：hour、day、week、month
     * @return 统计结果
     */
    List<Map<String, Object>> selectAlarmCountByTime(Long schoolId, Date startTime, Date endTime, String groupBy);

    /**
     * 按报警类型统计
     * 
     * @param schoolId 学校ID（可选）
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 统计结果
     */
    List<Map<String, Object>> selectAlarmCountByType(Long schoolId, Date startTime, Date endTime);

    /**
     * 按地理位置统计报警热点
     * 
     * @param schoolId 学校ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 热点数据
     */
    List<Map<String, Object>> selectAlarmHotspots(Long schoolId, Date startTime, Date endTime);

    /**
     * 新增报警记录
     * 
     * @param alarmRecord 报警记录
     * @return 结果
     */
    int insertAlarmRecord(AlarmRecord alarmRecord);

    /**
     * 修改报警记录
     * 
     * @param alarmRecord 报警记录
     * @return 结果
     */
    int updateAlarmRecord(AlarmRecord alarmRecord);

    /**
     * 批量删除报警记录
     * 
     * @param alarmIds 需要删除的报警记录主键集合
     * @return 结果
     */
    int deleteAlarmRecordByAlarmIds(Long[] alarmIds);

    /**
     * 删除报警记录信息
     * 
     * @param alarmId 报警记录主键
     * @return 结果
     */
    int deleteAlarmRecordByAlarmId(Long alarmId);

    /**
     * 分配报警处理人
     * 
     * @param alarmId 报警ID
     * @param handlerUserId 处理人ID
     * @return 结果
     */
    int assignAlarmHandler(Long alarmId, Long handlerUserId);

    /**
     * 开始处理报警
     * 
     * @param alarmId 报警ID
     * @param handlerUserId 处理人ID
     * @return 结果
     */
    int startHandleAlarm(Long alarmId, Long handlerUserId);

    /**
     * 完成报警处理
     * 
     * @param alarmId 报警ID
     * @param handleResult 处理结果
     * @return 结果
     */
    int completeAlarmHandle(Long alarmId, String handleResult);

    /**
     * 关闭报警
     * 
     * @param alarmId 报警ID
     * @param closeReason 关闭原因
     * @return 结果
     */
    int closeAlarm(Long alarmId, String closeReason);

    /**
     * 转接报警
     * 
     * @param alarmId 报警ID
     * @param newHandlerUserId 新处理人ID
     * @param transferReason 转接原因
     * @return 结果
     */
    int transferAlarm(Long alarmId, Long newHandlerUserId, String transferReason);

    /**
     * 升级报警等级
     * 
     * @param alarmId 报警ID
     * @param newLevel 新等级
     * @param upgradeReason 升级原因
     * @return 结果
     */
    int upgradeAlarmLevel(Long alarmId, Integer newLevel, String upgradeReason);

    /**
     * 批量更新报警状态
     * 
     * @param alarmIds 报警ID列表
     * @param handleStatus 处理状态
     * @param handlerUserId 处理人ID
     * @return 结果
     */
    int updateAlarmStatusBatch(Long[] alarmIds, Integer handleStatus, Long handlerUserId);

    /**
     * 自动分配报警处理人
     * 
     * @param alarmId 报警ID
     * @return 结果
     */
    int autoAssignAlarmHandler(Long alarmId);
} 